package com.liuhm.service;

import io.minio.messages.Bucket;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.io.InputStream;
import java.util.List;

/**
 * minio Service
 *
 * @author liuhaomin
 * @date 2020/8/18
 */
public interface MinioService {


    /**
     * 判断 bucket是否存在
     *
     * @param bucketName
     * @return
     */
    boolean bucketExists(String bucketName);

    /**
     * 创建 bucket
     *
     * @param bucketName
     */
    void makeBucket(String bucketName);
    /**
     * 设置bucket的策略
     *
     * @param bucketName
     * @param policy
     */
    void setBucketPolicy(String bucketName,String policy);
    /**
     * 文件上传
     *
     * @param bucketName
     * @param objectName
     * @param filename
     */
    void putObject(String bucketName, String objectName, String filename);

    /**
     * 文件上传
     *
     * @param bucketName
     * @param objectName
     * @param stream
     */
    void putObject(String bucketName, String objectName, InputStream stream);

    /**
     * 文件上传
     *
     * @param bucketName
     * @param multipartFile
     */
    void putObject(String bucketName, MultipartFile multipartFile, String filename);

    /**
     * 删除文件
     * @param bucketName
     * @param objectName
     */
    boolean removeObject(String bucketName, String objectName);

    /**
     * 下载文件
     *
     * @param fileName
     * @param response
     */
    void downloadFile(String bucketName, String fileName, HttpServletResponse response);

    /**
     * 获取文件路径
     * @param bucketName
     * @param objectName
     * @return
     */
    String getObjectUrl(String bucketName, String objectName);
    /**
     * 列出所有存储桶
     *
     * @return
     */
    List<Bucket> listBuckets();
    /**
     * 列出存储桶中的所有对象名称
     *
     * @param bucketName 存储桶名称
     * @return
     */
    List<String> listObjectNames(String bucketName);
    /**
     * 获取存储桶的策略
     *
     * @param bucketName 存储桶名称
     */
    String getBucketPolicy(String bucketName) ;
    /**
     * 获取文件链接
     *
     * @param bucketName 存储桶名称
     * @param objectName 存储桶里的对象名称
     * @param expires 超过期时间
     */
     String presignedGetObject(String bucketName, String objectName, Integer expires);
}
